home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 42 / Amiga Format AFCD42 (Issue 126, Aug 1999).iso / -serious- / hardware / scsiquery / scsiquery.readme < prev    next >
Text File  |  1999-05-17  |  9KB  |  244 lines
  1. Short:    Prints internal infos of SCSI devices
  2. Uploader: thor@einstein.math.tu-berlin.de (Thomas Richter)
  3. Author:   thor@einstein.math.tu-berlin.de (Thomas Richter)
  4. Type:     disk/misc
  5. Version:  1.20
  6. Requires: Os 2.04, a true SCSI-2 device (HD,CD mostly)
  7.  
  8.  
  9. _____________________________________________________________________________
  10.  
  11. Changes made for 1.20:
  12.  
  13. - Fixed a *fatal* bug that could have caused really serious crashes.
  14.   Forgot to cast correctly, leading trashing innocent memory. Outch!
  15.   *Sorry, sorry, sorry, sorry!*
  16. - Enhanced the Iomega extension output.
  17. _____________________________________________________________________________
  18.  
  19. Changes made for 1.19:
  20.  
  21. - Made the defect list format selectable, with autoselect for Iomega.
  22. - SCSIQuery prints now the extended INQUIRY data.
  23. - SCSIQuery detects now automatically whether a device name or a DOS
  24.   device driver is given.
  25. _____________________________________________________________________________
  26.  
  27. Changes made for 1.18:
  28.  
  29. - Added more sanity checks, fixed a possible enforcer hit. Thanks to 
  30.   Gene Heskett for reporting.
  31. - Changed the bad block default format to head/sector addressing rather
  32.   than bytes from index. This avoids trouble with Iomega devices.
  33. _____________________________________________________________________________
  34.  
  35. This tool prints all internal information of a SCSI device it can hold
  36. of, including the mode pages and the bad block lists. This might be 
  37. interesting for developers of SCSI software and hardware.
  38.  
  39. SCSIQuery replaces the older ProbSCSI which doesn't seem to run stable under
  40. certain (and in some sense broken) hardware, like the CyberSCSI device
  41. which doesn't seem to follow the RKRMs on each word. 
  42.  
  43.  
  44. Features:
  45.  
  46.     - Prints the device inquiry status
  47.     - Prints SCSI mode pages by their structure. It knowns most
  48.       HD and CD rom pages, and unknown pages are printed in hex dump.
  49.     - Prints the device capacity.
  50.     - Prints the defect list.
  51.     - Knows some Iomega extensions, most noticable for ZIP and JAZ.    
  52.       However, this is far from being complete due to the strange
  53.       information policy of Iomega.
  54.     - tested on the gvpscsi.device, the oktagon.device and the
  55.       (cyber)scsi.device. Should work on every device that follows
  56.       the RKRMs scsi.device documentations (roughly, at least).
  57.  
  58. To do:
  59.     Quite a lot, actually. However, it doesn't look I'm gonna have a
  60.     lot of time to develop this program further. It currently does what
  61.     it is supposed to do, but could do a lot better.
  62.  
  63.     - A GUI is missing. I'm just to lazy to write one in the current
  64.       state of this program.
  65.     - SCSIQuery doesn't allow to change or save the mode pages.
  66.     - Only mode pages for HD and CD are supported, no scanner/printer/
  67.       floptical and other SCSI device support. More mode pages might
  68.       be added on request.
  69.     - No LOG PAGES support yet.
  70.     - The readme is really a bit unhelpful. This program really lacks
  71.       a full detailed guide. However, lack of time... (-;
  72.  
  73.  
  74. Additional note:
  75.  
  76. Requests about what the output of this program means ARE NOT welcome. The
  77. SCSI-II specifications are available in public and they include all this
  78. information. 
  79.  
  80.  
  81. WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED
  82.  
  83. More SCSI mode page informations. I'm able to implement all official pages
  84. of the SCSI-II specifications since I've a copy of the SCSI specifications,
  85. however, there are more, vendor specific pages I've no idea about. Getting
  86. hold of the Iomega specifications - not the output of the program - 
  87. would really, really help.
  88.  
  89. If you've ANY information about these (not the official SCSI-II pages!) 
  90. additional pages, please, please PLEASE LEMME KNOW!
  91.  
  92. WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED
  93. _________________________________________________________________________________
  94.  
  95. Installation:
  96.  
  97.     Just copy it whereever you want to keep it. Needs nothing more.
  98.  
  99.  
  100. Synopsis:
  101.  
  102. SCSIQuery HANDLER=DEVICE/A,UNIT/N,FLAGS/N,DEFECTLIST/K
  103.  
  104.     
  105.     HANDLER=DEVICE    the name of the DOS handler controlling a SCSI    
  106.             device. DO NOT specify handlers that are not
  107.             linked to SCSI devices, this will either abort
  108.             with an error message in the best case, or crashes
  109.             the system in the worst case. You *HAVE TO* place
  110.             a trailing colon ":", e.g. "ZIP:".
  111.             Alternatively, an exec style device, it *MUST*
  112.             end with ".device", e.g. "omniscsi.device"
  113.  
  114.     UNIT        the unit of the exec device to investigate, required
  115.             if an exec device name was specified.
  116.  
  117.     FLAGS        flags used for opening the specific device;
  118.             defaults to zero and are not required in most cases.
  119.  
  120.     DEFECTLIST    the type of defect list to inquiry from the device.
  121.             Possible defect list specifiers are:
  122.  
  123.         OFF        Do not print a defect list.
  124.         INDEX        Specify defaults as bytes from an index on 
  125.                 the tracks.
  126.         PHYSICAL    Specify defaults as physical head, cylinder
  127.                 and block.
  128.         BLOCK        Specify defects as block offsets from the
  129.                 start of the drive.
  130.         DEFAULT        Use the INDEX method for all drivers except
  131.                 for Iomega devices which use the PHYSICAL
  132.                 type.
  133.  
  134.  
  135. Examples:
  136.  
  137.  
  138. To investigate your system partition, try:
  139.  
  140. SCSIQuery DH0:
  141.  
  142.  
  143. To print information about your CD ROM, try:
  144.  
  145. SCSIQuery CD0:
  146.  
  147.  
  148. To query the SCSI device connected to the "gvpscsi.device", unit 6, try:
  149.  
  150. SCSIQuery gvpscsi.device UNIT=6
  151.  
  152.  
  153. To query the SCSI device connected to the "oktagon.device", unit 0, try:
  154.  
  155. SCSIQuery oktagon.device UNIT=0
  156.  
  157. _____________________________________________________________________________
  158.  
  159. Special thanks goes to Werner Müller for testing. This program was actually
  160. written to help him finding problems in his SCSI configuration.
  161. _____________________________________________________________________________
  162.  
  163.                          The THOR-Software Licence (v2, 24th June 1998)
  164.  
  165.  
  166. This License applies to the computer programs known as "SCSIQuery".
  167. The "Program", below, refers to such program. The "Archive" refers to the 
  168. original and unmodified package of distribution, as prepared by the author 
  169. of the Program. Each licensee is addressed as "you".
  170.  
  171.  
  172.  
  173. The Program and the data in the archive are freely distributable
  174. under the restrictions stated below, but are also Copyright (c)
  175. Thomas Richter.
  176.  
  177. Distribution of the Program, the Archive and the data in the Archive by a
  178. commercial organization without written permission from the author to any
  179. third party is prohibited if any payment is made in connection with such
  180. distribution, whether directly (as in payment for a copy of the Program) or
  181. indirectly (as in payment for some service related to the Program, or
  182. payment for some product or service that includes a copy of the Program
  183. "without charge"; these are only examples, and not an exhaustive enumeration
  184. of prohibited activities).
  185.  
  186.  
  187. However, the following methods of distribution
  188. involving payment shall not in and of themselves be a violation of this
  189. restriction:
  190.  
  191.  
  192. (i) Posting the Program on a public access information storage and
  193. retrieval service for which a fee is received for retrieving information
  194. (such as an on-line service), provided that the fee is not
  195. content-dependent (i.e., the fee would be the same for retrieving the same
  196. volume of information consisting of random data).
  197.  
  198.  
  199. (ii) Distributing the Program on a CD-ROM, provided that
  200.  
  201. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  202. especially this licence agreement;
  203.  
  204. b) the CD-ROM is made available to the public for a nominal fee only,
  205.  
  206. c) a copy of the CD is made available to the author for free except for
  207. shipment costs, and
  208.  
  209. d) provided further that all information on such CD-ROM is redistributable
  210. for non-commercial purposes without charge.
  211.  
  212.  
  213. Redistribution of a modified version of the Archive, the Program or the
  214. contents of the Archive is prohibited in any way, by any organization,
  215. regardless whether commercial or non-commercial. Everything must be kept
  216. together, in original and unmodified form.
  217.  
  218.  
  219.  
  220.  
  221. Limitations.
  222.  
  223.  
  224. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  225. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  226. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  227. PARTICULAR PURPOSE AND NONINFRINGEMENT